home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / gen_bbs / flist202.zip / FILELIST.DOC < prev    next >
Text File  |  1996-11-23  |  6KB  |  105 lines
  1. *************************     FILELIST v2.01     ******************************
  2.  
  3. A program for use with a TBBS setup for making a complete listing of .dir and 
  4. .far files. 
  5.  
  6.                      Version 1, (c) Tom Parker, 1989
  7.                      Version 2, (c) David Rance, 1996
  8.  
  9. Typing FILELIST on the command line gives you the following display:
  10.  
  11.         Usage:  Filelist <config file> [options]
  12.  
  13.         Options:
  14.             -d  print file's date as DD/MM/YY
  15.             -m  print file's date as MM/DD/YY
  16.             -o  display file's owner
  17.  
  18.         Note:  Bad options will not cause an abort!
  19.  
  20.  
  21. An option's natural state is off unless specified.
  22.  
  23. CONFIGURATION
  24.  
  25. Included is a sample configuration file. For simplicity it is the same as a 
  26. .far file except for one thing - you are able to list other .far files in the 
  27. configuration.  A note of warning however, DO NOT make a recursive reference 
  28. within your configuration files.  Filelist has no capabilities of detecting 
  29. recursive references, and it'll likely fill up your hard disk with the same 
  30. directories over and over again. (An example of a recursive reference would be 
  31. listing a.far in b.far, and b.far in a.far.) 
  32.  
  33. DISCLAIMER
  34.  
  35. You use this program at your own risk. It has received an hour or two's testing 
  36. here at Ichthus and it is now in regular use. It works here, but I don't 
  37. guarantee that it will work for you. In fact the program comes with no 
  38. guarantees at all and you use it entirely at your own risk. However, I would be 
  39. glad to receive any feedback, good or bad. 
  40.  
  41. TBBS is a trademark of eSoft Inc.
  42.  
  43. David Rance
  44. 23rd November, 1996
  45.  
  46. The revising author may be contacted at:
  47.  
  48. Fidonet:  David Rance  2:252/110
  49. Internet: david.rance@ichthus.dircon.co.uk
  50. BBS:      Ichthus (Reading), UK +44-118-946-1466 or 946-4937
  51. Address:  Middelburg House, 10b Woods Road, Caversham,
  52.           READING, RG4 6NA, England
  53.  
  54. I am indebted to Tom Parker, the original author of this program. All I have 
  55. done is to bring the program up-to-date and add a little (but not a lot!) 
  56. sophistication.
  57.  
  58. /****************************************************************************/
  59. /*           Filelist v2.02:  Changes copyright 1996 by David Rance         */
  60. /*                                                                          */
  61. /*      23/11/96 v2.02:  A switch added, -m, to allow the date to be        */
  62. /*                       printed in MM/DD/YY format. Also tidied up         */
  63. /*                       alignment of continuation lines when the date is   */
  64. /*                       not included.                                      */
  65. /*      13/10/96 v2.01:  If the description of a file contained an          */ 
  66. /*                       apostrophe (the same character that starts the     */
  67. /*                       owner name) and there wasn't an owner name, then   */
  68. /*                       Filelist complained that the entry was mangled.    */
  69. /*                       Fixed. (Been meaning to fix this ever since I got  */
  70. /*                       the program seven years ago!)                      */
  71. /*      27/01/96 v2.00:  Tom Parker's Turbo C code altered slightly to make */
  72. /*                       compilation under Microsoft C possible ('cos       */
  73. /*                       that's the only compiler I've got!). Code added    */
  74. /*                       to recognise "!~" comment lines in .far files.     */
  75. /*                       Coded added to ignore flags field in .far files.   */
  76. /*                       Files now display in uppercase and date in         */
  77. /*                       European standard. Code added to display a date of */
  78. /*                       compilation and a signature at the end of the file */
  79. /*                                                                          */
  80. /*  Filelist v1.04:  Copyright February 9th, 1989 by Tom Parker.            */
  81. /*                   All rights reserved.                                   */
  82. /*                                                                          */
  83. /*      02/23/89 v1.04:  Expanded the maximum length of a line to 512 bytes.*/
  84. /*      02/19/89 v1.03:  Changed the format of directory listings to allow  */
  85. /*                       the date to be included and take less space in     */
  86. /*                       terms of padding.  Also, made the directory parser */
  87. /*                       more likely to reject entries that TBBS would not  */
  88. /*                       list.                                              */
  89. /*      02/12/89 v1.02:  Allowed an absence of an owner in a directory entry*/
  90. /*                       and toughened up testing of a directory entry.     */
  91. /*      02/11/89 v1.01:  Fixed two bugs which were the result of inadequate */
  92. /*                       testing.  The first was the way it parsed a        */
  93. /*                       directory entry.  On entries where there were more */
  94. /*                       than one space between the directory entry to      */
  95. /*                       display, and the user's ID, the user's idea would  */
  96. /*                       be (a) blank(s), and the user's ID would end up in */
  97. /*                       the comment.  The solution was to parse part of the*/
  98. /*                       string one way, and the rest another.  The other   */
  99. /*                       bug was that on comment extentions, the ">"        */
  100. /*                       charactar on the first part of the comment was not */
  101. /*                       recognized.  That too is now fixed.                */
  102. /*      02/09/89 v1.00:  Started.                                           */
  103. /****************************************************************************/
  104.  
  105.